Release 10.1A: OpenEdge Development:
Progress 4GL Reference

UNDERLINE statement

Underlines a field or variable, using the next display line for the underline.

Note: Does not apply to SpeedScript programming.

Syntax

UNDERLINE [ STREAM stream ] field ... [ frame-phrase ]

STREAM stream

Specifies the name of a stream. If you do not name a stream, Progress uses the unnamed stream. See the DEFINE STREAM statement reference entry in this book and the chapter on alternate I/O sources in OpenEdge Development: Programming Interfaces for more information on streams.

field

Represents the name of the field or variable you want to underline.

frame-phrase

Specifies the overall layout and processing properties of a frame. For more information on frame-phrase, see the Frame phrase reference entry.

Example

This procedure produces a report of customer records, categorized by state. When the last customer for a certain state has been displayed (determined by the LAST-OF function), the UNDERLINE statement underlines the state field.

r-under1.p

FOR EACH customer BREAK BY state WITH USE-TEXT: DISPLAY state cust-num name. IF LAST-OF(state) THEN UNDERLINE state. END.

Notes

Use The UNDERLINE statement to highlight fields or to underline accumulated values that you calculated using functions other than the automatic aggregate functions supplied with Progress.
When determining the position within a DOWN frame, the DOWN statement and the UP statement count the line used by an underline.
Even if the layout of a DOWN frame takes multiple screen lines, the underline takes just one line on the screen.
For a 1 DOWN frame or single frame, the UNDERLINE does not appear. Instead, Progress clears the frame.

See also

DEFINE STREAM statement, Frame phrase